package com.hh.hhpicturebackend.service;

import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import com.hh.hhpicturebackend.model.dto.space.SpaceAddRequest;
import com.hh.hhpicturebackend.model.dto.space.SpaceQueryRequest;
import com.hh.hhpicturebackend.model.entity.Space;
import com.hh.hhpicturebackend.model.entity.User;
import com.hh.hhpicturebackend.model.vo.SpaceVO;

import javax.servlet.http.HttpServletRequest;

/**
 * @author hanhui
 * @description 针对表【space(空间)】的数据库操作Service
 * @createDate 2025-05-15 16:19:36
 */
public interface SpaceService extends IService<Space> {
    /**
     * 获取查询包装类
     *
     * @param spaceQueryRequest 空间查询请求参数
     * @return 查询包装类对象
     */
    QueryWrapper<Space> getQueryWrapper(SpaceQueryRequest spaceQueryRequest);

    /**
     * 获取图片封装类
     *
     * @param space   空间实体对象
     * @param request HTTP请求对象
     * @return 空间视图对象
     */
    SpaceVO getSpaceVO(Space space, HttpServletRequest request);

    /**
     * 分页获取空间封装类
     *
     * @param spacePage 空间分页对象
     * @param request   HTTP请求对象
     * @return 分页后的空间视图对象
     */
    Page<SpaceVO> getSpaceVOPage(Page<Space> spacePage, HttpServletRequest request);

    /**
     * 添加空间
     *
     * @param spaceAddRequest 空间添加请求参数
     * @param loginUser       当前登录用户
     * @return 新增空间的ID
     */
    long addSpace(SpaceAddRequest spaceAddRequest, User loginUser);

    /**
     * 校验空间信息
     *
     * @param space 空间实体对象
     * @param add   是否为添加操作
     */
    void validSpace(Space space, boolean add);

    /**
     * 根据空间等级填充空间信息
     *
     * @param space 空间实体对象
     */
    void fillSpaceBySpaceLevel(Space space);

    /**
     * 检查空间权限
     *
     * @param loginUser 当前登录用户
     * @param space     空间实体对象
     */
    void checkSpaceAuth(User loginUser, Space space);
}
